DS-CD ROM 2 1993 August

home *** CD-ROM | disk | FTP | other *** search

/ DS-CD ROM 2 1993 August / DS CD-ROM 2.Ausgabe (August 1993).iso / programm / ds0328 / clipper / cb / cb.exe / HANDBUCH.TXT < prev next >

Wrap

Text File | 1992-08-12 | 20.0 KB | 460 lines

CB.OBJ Version 1.0 Die Funktionssammlung für den beleglosen Datenträgeraustausch CB.OBJ Seite 1 ────────────────────────────────────────────────────────────────────── ┌───────────────────────────────┐ │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓███████████████ │ Mitglied der │ ▓ ▓▓▓▓███ █████ │ │ ▓▓ ▓▓▓▓▓▓▓ ▓▓▓██ ████████████ │ D.S. - Deutschsprachige Shareware │ ▓▓ ▓▓▓▓▓▓▓▓ ▓▓██ ████████████ │ (Autoren- und Händlervereinigung) │ ▓▓ ▓▓▓▓▓▓▓▓ ▓▓██ ████████████ │ │ ▓▓ ▓▓▓▓▓▓▓▓ ▓▓███ █████ │ │ ▓▓ ▓▓▓▓▓▓▓▓ ▓▓█████████ █████ │ │ ▓▓ ▓▓▓▓▓▓▓ ▓▓▓█████████ █████ │ │ ▓ ▓▓▓▓██ █████ │ │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓███████████████ │ │ Deutschsprachige Shareware │ ├───────────────────────────────┤ │ Autoren- & Händlervereinigung │ └───────────────────────────────┘ D.S.-Koordinatoren Firma Bernd Hohenester ist anerkanntes Autorenmitglied der D.S. - Deutschsprachige Shareware, Autoren- und Händlervereinigung. Sollte sich im Geschäftsbetrieb mit einem unserer Mitglieder ein die PD/Freeware/Shareware-bezogenes Problem ergeben, das Sie im persönlichen Kontakt nicht mit diesem Mitglied lösen können, so sollten Sie sich an einen unserer Koordinatoren wenden. Er wird versuchen, zwischen Ihnen und dem Mitglied zu vermitteln. Er kann Ihnen jedoch in dieser Funktion keine unmittelbare Hilfestellung geben, wenn Sie bei der Anwendung von Programmen Schwierigkeiten haben. Bitte wenden Sie sich schriftlich bei Problemen mit Händlermitgliedern an Werner Heidel, Im Huferfeld 5, 4000 Düsseldorf 30 und bei Problemen mit Autorenmitgliedern an Hans-Peter Winkelmann, Am Lohehof 9, 4250 Bottrop. Was ist Public-Domain ? Programme, die der Autor ohne jede Einschränkungen zum Vertrieb und Kopieren freigegeben hat. Auf diese Software gibt es keinerlei Copyright, jeder kann mit dem Programm machen, was er will, auch in eigene Programme einbinden und verwenden. Was ist Freeware ? Programme, die unter dem Copyright des Autors stehen und nach seinen Maßgaben zum Kopieren freigegeben sind. Was ist Shareware ? Programme, die nach den Vorgaben des Autors getestet werden dürfen ohne gleich das Nutzungsrecht an dem Programm erwerben zu müssen (Prüf-vor-Kauf System). Shareware steht unter dem Copyright des Autors, der sich sämtliche Rechte an dem Programm vorbehält. Wollen Sie ein Shareware-Programm über die Prüfauflagen des Autors hinaus benutzen, so sind Sie verpflichtet, das Nutzungsrecht an diesem Programm zu erwerben (Registrierung). CB.OBJ Seite 2 ────────────────────────────────────────────────────────────────────── ALLGEMEINES: Aufgrund der ca. 5 Milliarden Überweisungen bzw. Lastschriften jährlich sind Banken und Sparkassen an der elektronischen Abwicklung dieser Bu- chungen sehr interessiert. Die Umstellung des Zahlungsverkehrs vom automatisierten Ausdruck von Scheck-, Überweisungs- und Lastschriftbelegen auf den beleglosen Daten- trägeraustausch fängt die bisherigen hohen Kosten für die Belege auf. Außerdem bieten Banken und Sparkassen unter Umständen weitere Vorteile (Buchung am selben Tag, reduzierte Gebühren usw.) Mit den Funktionen in CB.OBJ können Sie als Clipper-Programmierer Ihre Applikationen auf einfache Weise auf den beleglosen Datenträgeraustausch erweitern. CB.OBJ benutzt ausschließlich dBASE- bzw. Clipper-Befehle und Funktionen. Sie wurde mit Clipper Sommer 87 geclippert. Für die Testphase Ihrer App- likation nutzen Sie CB_DEBUG.OBJ (darin sind die Zeilennummern des Quell- codes enthalten). Um die Funktionen nutzen zu können, binden Sie CB.OBJ einfach beim Lin- ken Ihrer Applikation ein. GRUNDSÄTZLICHES ZUM BELEGLOSEN DATENTRÄGERAUSTAUSCH: Um Ihre Zahlungen "elektronisch" abwickeln zu können, brauchen Sie zu- nächst eine Applikation, die das Erstellen der Datei DTAUS1 auf Diskette erledigt. Außerdem müssen Sie mit Ihrer Bank eine "Vereinbarung über die Teilnah- me am beleglosen Datenträgeraustauschverfahren" schließen. Es ist empfehlenswert, vor der ersten Zahlungsabwicklung eine Musterdis- kette zu erstellen und diese von Ihrer Bank prüfen zu lassen. Für Auskünfte stehen Ihnen die Mitarbeiter Ihrer Bank zur Verfügung. ZUR ARBEITSWEISE VON CB.OBJ Auf der eingereichten Diskette darf sich nur eine physikalische Datei DTAUS1 befinden, deren Format streng reglementiert ist. Diese Datei kann jedoch mehrere logische Dateien enthalten. Jede dieser logischen Dateien ist wie folgt aufgebaut: genau ein A-Satz: Dateivorspann (enthält hauptsächlich die eigene Bankverbindung) mehrere C-Sätze: die eigentlichen Zahlungsvorgänge (Überweisungen oder Lastschriften) genau ein E-Satz: Dateinachspann (enthält Kontrollsummen) In einer logischen Datei sind nur entweder Überweisungen oder Lastschrif- ten erlaubt. Eine Mischung ist nicht zulässig. CB.OBJ Seite 3 ────────────────────────────────────────────────────────────────────── Die Funktionen in CB.OBJ erstellen die temporäre Datei DTAUS1.DBF und legen dort die benötigten Datensätze an. Dabei werden die Angaben in das geforderte Format gebracht. Zusätzlich werden die von den Banken gefor- derten Plausibilitätsprüfungen durchgeführt, einschließlich der Prüfzif- fernberechnung für die Kontonummern. Falls Fehler auftreten, unterbleibt das Anlegen des Datensatzes. Dadurch wird erreicht, daß sich nur integre Daten auf der Diskette befinden und Ihre Bank diese Daten problemlos ver- arbeiten kann. Im zweiten Schritt werden die Daten auf Diskette ausgegeben, die Sie an- schließend bei der Bank einreichen können. BESCHREIBUNG DER FUNKTIONEN: Anschließend folgt eine Beschreibung der in CB.OBJ enthaltenen Funk- tionen. Die Datei SAMPLE.ASC verdeutlicht Ihnen, wie Sie die Funktionen in Ihre Applikation einbinden. Der kleingeschriebene Buchstabe am Anfang der Variablennamen gibt den Typ an: c - Character (Zeichen) n - numerisch l - logisch CB.OBJ Seite 4 ────────────────────────────────────────────────────────────────────── Funktion CB_A Aufgabe: Legt die temporäre Datei DTAUS1.DBF im aktuellen Verzeich- nis an, sofern sie nicht schon existiert. Anschließend wird der A-Satz der folgenden logischen Datei angelegt. Syntax: nCBA_RUECK = CB_A(cENAME, cEBLZ, cEKTONR, cEMOD, lGUT, nARBEIT) Parameter: cENAME = eigener Name, max. 27 Stellen cEBLZ = eigene Bankleitzahl, 8 Stellen cEKTONR = eigene Kontonummer, max. 10 Stellen cEMOD = Kennziffer für das Prüfziffernverfahren, 2 Stellen "09" = Kontonummer nicht prüfen lGUT = .T. bei Gutschriften .F. bei Lastschriften nARBEIT = Nummer des Arbeitsbereichs, 1 Stelle Rückgabe: nCBA_RUECK = 0 - kein Fehler aufgetreten 1 - ungültige Bankleitzahl 2 - kein Name angegeben 3 - ungültige Kontonummer 4 - Arbeitsbereich kleiner 0 oder größer 10 Hinweis: Um die Prüfziffernberechnung der Kontonummer zu nutzen, be- nötigen Sie eine Bankleitzahlenbibliothek, in der die ent- sprechenden Kennziffern enthalten sind. Sie können diese Bibliothek gesondert beziehen. Ansonsten müssen Sie immer cEMOD = "09" setzen, da hier keine Prüfziffernberechnung erfolgt. Die temporäre Datei wird im angegebenen Arbeitsbereich geöffnet, aber durch die Funktion nicht geschlossen. CB.OBJ Seite 5 ────────────────────────────────────────────────────────────────────── Funktion CB_C Aufgabe: Legt einen C-Satz (eine einzelne Überweisung oder Last- schrift) mit den formatierten Angaben an. Syntax: nCBC_RUECK = CB_C(cFNAME, cFBLZ, cFKTONR, cFMOD, nFBETRAG, cTS, cLISTE) Parameter: cFNAME = Name des Kunden, max. 27 Stellen cFBLZ = Bankleitzahl des Kunden, 8 Stellen cFKTONR = Kontonummer des Kunden, max. 10 Stellen cFMOD = Kennziffer für das Prüfziffernverfahren, 2 Stellen nFBETRAG = Betrag, max. 11 Stellen (einschl. Dezimalstellen) cTS = Textschlüssel, 2 Stellen 1. Stelle = 1 - Überweisungen 2 - Lohn-, Gehalts-, Rentengut- schriften 3 - Vermögenswirksame Leistungen 2. Stelle = Einerstelle der Jahreszahl, für die die vermögenswirksamen Leistungen gewährt werden cLISTE = Array, 16 Elemente, je max. 27 Stellen Rückgabe: nCBC_RUECK = 0 - kein Fehler aufgetreten 1 - ungültige Bankleitzahl des Kunden 2 - Name des Kunden nicht angegeben 3 - ungültige Kontonummer des Kunden 4 - Betrag kleiner oder gleich 0 5 - erste Stelle des Textschlüssels ungültig 6 - zweite Stelle des Textschlüssels ungültig Hinweis: Erläuterungen zum Textschlüssel Sie müssen den Textschlüssel bei Überweisungen definieren. Die erste Stelle gibt dabei die Art des Schlüssels an, die zweite Stelle ist nur bei Zahlung von vermögenswirk- samen Leistungen erforderlich. Bei Lastschriften ist der Schlüssel vorgegeben. Beispiele: Lastschriften parC4 = " " oder "00" oder "10" usw. Gutschriften parC4 = "10" - einfache Überweisung parC4 = "20" - Lohn-, Gehalts-, Rentengut- schrift parC4 = "32" - vermögenswirksame Leistung für das Jahr 1992 MIT DIESER SHAREWARE-VERSION KÖNNEN NUR EINFACHE ÜBERWEI- SUNGEN DURCHGEFÜHRT WERDEN! DIE ÜBRIGEN TEXTSCHLÜSSEL WERDEN NICHT UNTERSTÜTZT! Erläuterungen zum Array Das Array dient zur Übergabe der Textzeilen der Zahlung. Für die Textzeilen gilt allgemein, daß sie nur belegt werden, sofern sie unbedingt notwendig sind, und ihr Inhalt so kurz wie möglich gehalten wird. CB.OBJ Seite 6 ─────────────────────────────────────────────────────────────────────────────── Die einzelnen Elemente sind speziellen Textzeilen zu- geordnet: array[1] = Verwendungszweck, 1. Zeile hier sollten Sie die Angaben einsetzen, die für eine Zuordnung unbedingt wichtig sind. array[2] = eigener Name, 2. Zeile array[3] = Verwendungszweck, Zeile 2 bis bis array[15] Zeile 14 array[16] = Name des Kunden, 2. Zeile Auch diese Funktion schließt die temporäre Datei DTAUS1.DBF nicht. CB.OBJ Seite 7 ────────────────────────────────────────────────────────────────────── Funktion CB_E Aufgabe: Die Funktion legt den E-Satz der logischen Datei an und schließt die temporäre Datei DTAUS1.DBF Syntax: CB_E() Parameter: keine Rückgabe: immer 0 Hinweis: CB.OBJ Seite 8 ────────────────────────────────────────────────────────────────────── Funktion CB_DTAUS Aufgabe: Die Funktion gibt die Datei DTAUS1 auf Diskette aus und erstellt anschließend eine Sicherheitskopie der tempo- rären Datei. Syntax: nCBD_RUECK = CB_DTAUS(cLW, cDISK, nARBEIT) Parameter: cLW = Kennbuchstabe des Diskettenlaufwerks, 1 Stelle cDISK = Diskettenkapazität, 1 Stelle "1" = 360 KByte "2" = 720 KByte "3" = 1,2 MByte "4" = 1,4 MByte nARBEIT = Nummer des Arbeitsbereichs, 1 Stelle Rückgabe: nCBD_RUECK = 0 - kein Fehler aufgetreten 1 - temporäre Datei DTAUS1.DBF nicht gefunden 2 - ungültige Kennziffer für Diskettenkapazität 3 - Kennbuchstabe für Laufwerk ungleich A oder B 4 - Arbeitsbereich kleiner 0 oder größer 10 5 - Diskettenkapazität für vorhandene Daten zu gering Hinweis: Da die Daten in die Datei DTAUS1 auf Diskette "gedruckt" werden, müssen Sie nach Aufruf der Funktion den Drucker neu setzen! Diskettenkapazität Entnehmen Sie der folgenden Tabelle, wieviele Zahlungen auf Disketten der entsprechenden Kapazität passen: 360 KiloByte - max. 1414 Buchungen 720 KiloByte - max. 2850 Buchungen 1,2 MegaByte - max. 4740 Buchungen 1,4 MegaByte - max. 5692 Buchungen Die Anzahl der Buchungen verringert sich entsprechend, wenn Sie die möglichen Textzeilen voll ausnutzen. Im aktuellen Verzeichnis wird eine Sicherheitskopie der temporären Datei DTAUS1.DBF erstellt. Der Name dieser Datei setzt sich aus dem aktuellen Datum mit der Erwei- terung .DTz zusammen. Das "z" steht für einen Zähler. Beispiel: 120792.DT1 = erste Kopie am 12.07.1992 120792.DT2 = zweite Kopie am 12.07.1992 usw. CB.OBJ Seite 9 ────────────────────────────────────────────────────────────────────── Funktion CB_BEGLEIT Aufgabe: Die Funktion druckt für jede logische Datei die erforder- lichen Begleitscheine aus. Syntax: nCBB_RUECK = CB_BEGLEIT(cEBANK, cEORT, cDISK, nARBEIT) Parameter: cEBANK = Name der bezogenen Bank, max. 27 Stellen cEORT = Sitz der bezogenen Bank, max. 27 Stellen nARBEIT = Nummer des Arbeitsbereichs, 1 Stelle cDISK = Diskettenkapazität (siehe Funktion CB_DTAUS) Rückgabe: nCBB_RUECK = 0 - kein Fehler aufgetreten 1 - Arbeitsbereich kleiner 0 oder größer 10 2 - ungültige Kennziffer für Diskettenkapazität 3 - temporäre Datei DTAUS1.DBF nicht gefunden Hinweis: Der Drucker muß vor Aufruf der Funktion richtig gesetzt und bereit sein! Erst wenn die Daten mit der Funktion CB_DTAUS auf Diskette geschrieben wurden UND der Ausdruck der Begleitscheine er- folgte, MUSS die temporäre Datei DTAUS1.DBF gelöscht werden! Erläuterung zum Löschen der temporären Datei: Es ist möglich, mehrere logische Dateien in die temporäre Datei aufzunehmen und diese auf eine Diskette auszugeben. Beispiel: Die erste logische Datei enthält alle Beitrags- zahlungen der Mitglieder der Abteilung 1 eines Vereins (Lastschriften). Die zweite logische Datei enthält alle Beitragszahlungen der Mit- glieder der Abteilung 2. Anschließend werden beide logische Dateien in eine einzige Datei DTAUS1 auf Diskette ausgegeben. Dazu dürfen Sie nach den Zahlungen der Abtei- lung 1 die temporäre Datei DTAUS1.DBF NICHT löschen! Erst nach den Zahlungen der Abtei- lung 2 werden die Daten auf Diskette geschrie- ben (Funktion CB_DTAUS), die Begleitscheine gedruckt (Funktion CB_BEGLEIT) und anschlies- send die temporäre Datei DTAUS1.DBF gelöscht. CB.OBJ Seite 10 ────────────────────────────────────────────────────────────────────── COPYRIGHT: CB.OBJ ist eine durch das Urheberrechtsschutzgesetz geschützte Funktions- sammlung. Sie finden auf dieser Diskette eine voll funktionstüchtige Prüfversion. Diese Shareware-/Prüfversion darf sowohl kommerziell wie privat beliebig kopiert und verteilt werden. Nur durch Ihre Mithilfe bei der Werbung und durch den Direktvertrieb können Shareware-Produkte sehr preiswert angeboten werden. Bitte zahlen Sie bei regelmäßiger Benutzung dieses Programms die Lizenz- gebühr von DM 50,-. Sie erhalten dann die neueste Vollversion mit zu- sätzlichen Funktionen. Außerdem können Sie nur als registrierter Be- nutzer von CB.OBJ eine Bankleitzahlenbibliothek beziehen. Die Funk- tionssammlung ist auch als CB.DBO für dBASE IV erhältlich. Mit Ihrer finanziellen Unterstützung von Shareware-Autoren fördern Sie die Entwicklung preiswerter Software. Einen Bestellschein finden Sie in der Datei BESTELL.TXT. Ich übernehme keinerlei Haftung für Schäden an Rechnern oder Datenver- luste aus dem Gebrauch von CB.OBJ. Falls Sie Tips oder Verbesserungsvorschläge zu CB.OBJ haben, scheuen Sie sich nicht, diese mir mitzuteilen. Vielen Dank im voraus für Ihre Unterstützung. Erlangen, 12. August 1992 Bernd Hohenester Aschaffenburger Straße 16 8520 Erlangen Tel.: (09131) 4 87 88